package org.example.aienglishapp_login.mapper.login;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.example.aienglishapp_login.dto.login.RoleDTO;
import org.example.aienglishapp_login.entity.login.Role;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Set;

/**
 * 角色映射接口。
 * <p>
 * 该接口定义了与角色相关的数据库操作方法，并使用 MyBatis 进行持久层的交互。
 *
 * @author xlj
 * @version 1.0
 * @since 2024-10-1
 */
@Mapper
@Repository
public interface RoleMapper {

    /**
     * 根据角色名称查询角色信息。
     *
     * @param roleName 角色名称
     * @return 返回对应的角色对象，如果未找到则返回 null
     */
    Role findByRoleName(@Param("roleName") String roleName);

    /**
     * 检查指定的角色名称是否存在。
     *
     * @param roleName 角色名称
     * @return 如果存在返回 true，否则返回 false
     */
    boolean existsByRoleName(@Param("roleName") String roleName);

    /**
     * 检查指定的角色ID是否存在。
     *
     * @param id 角色ID
     * @return 如果存在返回 true，否则返回 false
     */
    boolean existsById(@Param("id") Long id);

    /**
     * 根据角色ID删除角色。
     *
     * @param id 角色ID
     */
    void deleteById(@Param("id") Long id);

    /**
     * 根据用户ID查询该用户所拥有的所有角色。
     *
     * @param userId 用户ID
     * @return 返回一个包含该用户所有角色的集合
     */
    Set<Role> findRolesByUserId(@Param("userId") Long userId);

    /**
     * 查询系统中所有的角色。
     *
     * @return 返回一个包含所有角色的列表
     */
    List<Role> findAllRoles();

    /**
     * 根据角色ID查询角色信息。
     *
     * @param id 角色ID
     * @return 返回对应的角色对象，如果未找到则返回 null
     */
    Role findById(@Param("id") Long id);

    /**
     * 更新角色信息。
     *
     * @param role 要更新的角色对象
     * @return 返回受影响的行数
     */
    int updateRole(Role role);

    /**
     * 插入角色和权限之间的关联关系。
     *
     * @param roleId       角色ID
     * @param permissionId 权限ID
     */
    void insertRolePermission(@Param("roleId") Long roleId, @Param("permissionId") Long permissionId);

    /**
     * 删除角色和权限之间的关联关系。
     *
     * @param roleId       角色ID
     * @param permissionId 权限ID
     */
    void deleteRolePermission(@Param("roleId") Long roleId, @Param("permissionId") Long permissionId);

    /**
     * 根据用户ID删除该用户的所有角色。
     *
     * @param userId 用户ID
     */
    void deleteRolesByUserId(@Param("userId") Long userId);

    /**
     * 插入新的角色。
     *
     * @param role 要插入的角色对象
     */
    void insert(Role role);

    /**
     * 在删除角色之前，清除该角色与权限之间的关联关系。
     *
     * @param roleId 角色ID
     */
    void deleteRolePermissions(@Param("roleId") Long roleId);

    /**
     * 根据权限ID查询拥有该权限的所有角色。
     *
     * @param permissionId 权限ID
     * @return 返回一个包含所有相关角色的列表
     */
    List<Role> findRolesByPermissionId(@Param("permissionId") Long permissionId);

    /**
     * 插入用户和角色之间的关联关系。
     *
     * @param userId 用户ID
     * @param roleId 角色ID
     */
    void insertUserRole(@Param("userId") Long userId, @Param("roleId") Integer roleId);

    /**
     * 根据用户ID获取角色列表（DTO）。
     *
     * @param userId 用户ID
     * @return 返回一个包含用户所有角色的 DTO 列表
     */
    List<RoleDTO> getUserRolesByUserId(@Param("userId") Long userId);
}